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PRONTO-DOS SUMMARY 

TO GET PRONTO-DOS IN MEMORY 

■ Boot the original ProntoDOS disk OR any disk you have 
created using ProntoDOS. 

TO REMOVE PRONTO-DOS FROM MEMORY 

■ Boot any non-PronloDOS disk. 

TO CREATE PRONTO-DOS DISKS 

■ CREATE NEW DISKS- Boot ProntoDOS. then INTT new 
disks (which will contain 15 extra sectors), OR... 

■ UPDATE EXISTING DISKS- Boot ProntoDOS and RUN 
PRONTO UPDATE (updated disks contain the standard 
number of free sectors). 

TO MOVE PRONTO-DOS TO HIGH-MEMORY 

(require! Apple lie OR older Apple with Language Card) 

■ Boot ProntoDOS. then BRUN DOS-UP. 

WARNINGS 

■ MAKE BACKUP COPIES of all disks before you update 
them to ProntoDOS. 

■ NEVER UPDATE COPY-PROTECTED DISKS. You will ruin 
them. Period. 

■ DON'T USE APPLE’S MASTER CREATE program on 
ProntoDOS disks. Doing so will destroy data In the disk’s 
15 extra sectors. 



USING PRONTO- 
DOS IS ALMOST 
UKE USING 
NORMAL APPl£ 
DOS. 


YOU MUST BOOT 
PRONTO-DOS TO 
INSTAU fT IN YOUR 
APPLE'S MEMORY. 


BOOT PRONTO- 
DOS, THEN INfT AS 
MANY DISKS AS 
YOU WANT. 



PRONTO-DOS 
GENERAL INFORMATION 

PronfoDOS Is a set ot assembly language modifications to 
Apple’s DOS 3.3. These modifications allow much faster han- 
dling of Basic and Binary files. Text files are not affected, 
although some bugs In Apple DOS pertaining to Text Files 
have been removed. To use ProntoDOS, you need an Apple 
II, ll-plus or lie with at least 48K and the Apple 3.3 (16-sector) 
Disk Operating System. 

ProntoDOS works exactly like Apple DOS. All com- 
mands are the same. All error messages are the same. All 
(lies and disks are the same. No conversion ot files, "muflln- 
Ing", or re-Inltlallzatlon ot disks Is necessary. Files created with 
ProntoDOS are exact duplicates ot tiles created with Apple 
DOS. ProntoDOS will accept all pokes found In Beagle Bros 
Tip Books and programs, Including DOS Boss, Key-Cat, Bea- 
gle Menu, and so on. 

Commands and tile structure are fully-documented In 
'The DOS Manual", which came with your Apple disk drive. 
None of that Information Is repeated here. 

For some baslo Information on how ProntoDOS does 
what It does, see the article by Tom Welshaar, "DOS Be Nim- 
ble. DOS Be Quick" In the March 1983 Softalk 

To get ProntoDOS running, boot the ProntoDOS disk or 
any disk you have updated with ProntoDOS. tt will load a 
version of Apple DOS that Includes the ProntoDOS modifica- 
tions. You will then have access to ProntoDOS's speed until 
you boot another disk or turn off your computer. If you boot 
another disk, the DOS on that disk will wipe out ProntoDOS. 
You can tell If ProntoDOS Is active by typing the CATALOG 
command. The area that normally says "DISK VOLUME ###" 
will say "PRONTO-DOS V###". 

Any disk you Initialize with the DOS "INIT command 
WHILE PRONTO-DOS IS ACTIVE will have ProntoDOS written on 
It. This means that whenever you boot these disks, ProntoDOS 
will be loaded automatically. 

When creating ProntoDOS disks with the INIT command, 
It Is highly-recommended that you DO NOT RUN ANY 
PROGRAMS (with the exception of PRONTO UPDATE) between 
the time you boot ProntoDOS and the time you INITIallze your 
disks. In particular, do not run any programs that Install 
themselves between DOS and Its buffers, such as GPLE or Flex 
Ted. 

Disks Initialized with ProntoDOS have an additional 
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ADD PRONTO-DOS 
TO DISKS THAT 
ALREADY HAVE 
DATA ON THEM. 


PRONTO-DOS 
HIDES ITSELF WEIL 


bonus— 15 extra sectors of free space, compared to disks 
Initialized with Apple DOS. 

You can also update your existing disks to PronfoDOS. 
To do this, boot the ProntoDOS disk and RUN the program 
called PRONTO UPDATE. Select Option-2. "Update DOS on 
Existing Disks". Instructions for using this option will appear on 
your screen. NOTE: ProntoDOS must be active In your 
computer when you update your disks. If standard Apple 
DOS Is active, your disks will be "updated" to standard Apple 
DOS. For complete Information, see Updating DOS on 
the next page. 

You can move DOS to a Language Card or to the upper 
reaches of the Apple lie's memory with the program DOS-UP. 
For complete Information see page 11. 

If you use a special version of DOS that must be booted 
from another disk so you can Interface with hard disks, disk 
emulators, clock cards, or other devices. BRUN HELLO 
PRONTO-DOS after booting the other disk. This program will 
poke the ProntoDOS modifications Into the DOS In memory. 
See page 11. 

If you own a Standard Apple II (the Integer Basic ver- 
sion), see the section called "ProntoDOS and Integer Basic 
Apples” on page 17. 

Memory Usage: Earlier versions of ProntoDOS used 
empty spaces normally present within the pre-Apple lie ver- 
sion of Apple DOS. This caused conflicts with several pro- 
grams that also tried to use this space. It also conflicted wtth 
the Apple lie version of DOS, which used one of these empty 
spaces. 

The version of ProntoDOS on this disk hides Itself In other 
areas of DOS. It Is very Improbable that any other program 
will poke changes Into areas of DOS that have been modi- 
fied by ProntoDOS, with one exception. Programs that use the 
empty space at location 47721-65 ($BA69-95) will overwrite 
both the new Apple lie version of DOS and ProntoDOS. 

All problems wtth ProntoDOS reported to date, except 
one, have been traced to programs that have modified this 
area or other areas of DOS. Again, to be safe, It Is highly- 
recommended you DO NOT RUN ANY PROGRAMS BETWEEN 
THE TIME YOU BOOT PRONTO-DOS AND THE TIME YOU INITIALIZE 
OR UPDATE DISKS you Intend to boot (except, of course, 
PRONTO UPDATE). 

The only problem reported by ProntoDOS users not asso- 
ciated with DOS modifications by alien programs Is that 
ProntoDOS, for very technical reasons related to a bug In the 
Apple Itself, will drive you r computer crazy If you ^ to BSAVE a 


range of memory that begin* between $C1 00 and SCI 03. Thl* 
area Is associated with software (or "tlrmware") on the peri- 
pheral card In Slot 1, usually a printer driver. The circumstan- 
ces under which a user would want to access this area with 
DOS are extremely rare. If you need to do It for some reason, 
use standard Apple DOS. Do not attempt to save this area 
using ProntoDOS. 

TEXT RLE BUGS The Apple APPEND command has always contained an 

exotic bug that caused It to fall whenever the stars were right. 
That bug has been removed In ProntoDOS. In addition, a 
complex bug relating to the use of the "R" and "B" parame- 
ters with Text Files has been fixed. If your programs use these 
parameters, see "ProntoDOS and Text Flies" on page 16. 

The standard Apple DOS skew pattern works best wtth 
ProntoDOS. If you have used Quality Software’s Bag of 
TrlcksP, or another program, to re-skew your disks, you will 
have to normalize them again to obtain maximum 
ProntoDOS speed. 


CREATING NEW 
PRONTO-DOS DISKS 

Turn off your Apple If it's not already off. Insert the original 
ProntoDOS disk or ANY ProntoDOS disk In your drive, and turn 
your Apple on to boot that disk. Now you may create new 
ProntoDOS disks using Apple’s normal INIT command. For 
example, Insert a new (or erasable) disk, and type: 

)INIT HELLO 

(Any legal file name Instead of "Hello” Is, of course, 
acceptable.) This will create a disk that, when booted, will 
Install ProntoDOS In your Apple’s memory. For more details 
on INIT, see your DOS MANUAL. For more on ProntoDOS'* INIT 
syntax, see page 10 of this manual. 

.7*3 -‘O 
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UPDATING DOS 
ON EXISTING DISKS 


To update existing disks, run the program PRONTO UPDATE, 
which Is on your original ProntoDOS disk. 

)RUN PRONTO UPDATE 
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Option (1) will take you to the ENHANCEMENT MENU, 
which allows you to customize ProntoDOS (see page 6). 
Option (2) will Update your existing disks so that your person- 
alized ProntoDOS will be active whenever those disks are 
booted. 

You may update disks wtth plain old (uncustomized) 
ProntoDOS. with Apple DOS. and with either of those after 
modifying them wtth Beagle Bros' DOS Boss program (DOS 
Boss allows you to rename DOS error messages and 
commands for program protection— try "/’’ for CATALOG, for 
example— and to personalize the Disk Volume heading, 
among other useful things.). 

ALL DISKS DO NOT It Is only necessary to update existing disks that you 

NEED TO BE INTEND TO BOOT. Disks used only for program or data storage 

u ' ' do not need to be updated. 



REMOVING 
PRONTO-DOS 
FROM A DISK 


DO MAKE BACKUP COPIES of all disks before updating. 

DON’T UPDATE copy-protected disks. 

DON’T UPDATE disks originally Initialized with DOS but from 
which DOS has been removed. 

To update your existing disks, choose Option 2 from the 
Main Menu of PRONTO UPDATE. To update disks and keep the 
same Hello File Name and "Run Command” as the original, 
simply Insert the disk to be updated and press RETURN. It 
takes less than 3 seconds to update each disk. 

If you would like to change the name of the Hello FUe on 

the disk, or If you would like the Hello File to be BRUN or 
EXECed Instead of RUN, press the SPACE BAR before pressing 
RETURN. You will be prompted to enter the new Hello File 
Name to be used as well as the new Run Command. 

To remove ProntoDOS from a disk, boot standard Apple 
DOS before running PRONTO UPDATE. You will then be able to 
re-update a disk back to Apple DOS. Only disks that were 
originally Initialized with Apple DOS can be converted back 
to Apple DOS. This Is because ProntoDOS disks use less room 
for DOS than Apple DOS disks. If you could put Apple DOS on 
a disk originally Initialized with ProntoDOS It would overwrite 
some of your data. Therefore, the Update feature will not 
allow you to do this. You will also be unable to update a disk 
that was originally INITIallzed without DOS. 


EVERY TIME YOU 
PRESS A NUMBER. 
STAND BY; THE DOS 
IN MEMORY IS 
BEING ALTERED. 


PROBLEMS WITH 

PRONTO-DOS 

ENHANCEMENTS 


PRONTO-DOS 

ENHANCEMENTS 

The PRONTO UPDATE program allows you to make certain 
helpful modifications to DOS. To use this Applesoft program. 
Insert your ProntoDOS disk, and enter 

)RUN PRONTO UPDATE 

You will be asked to choose between the Enhancement 
Menu and updating DOS on existing disks. Choose Optlorvl . 
You will then see the following menu- 


PRONTO UPDATE 
ENHANCEMENT MENU 

(1) "TYPE" COMMAND ACTIVE YES/NO 

(2) CTRL-C KILLS CATALOGS . . . YES/NO 

(3) (ESC) KILLS EXECS & READS YES/NO 

(4) AUTOMATIC VERIFY AFTER SAVE YES/NO 

(5) FORCE LANGUAGE CARD RELOAD . . YES/NO 

(6) PRINT DISK FREE SPACE YES/NO 

(7) PRINT BINARY FILE ADR & LEN YES/NO 

(8) INIT SAVES DOS & HELLO FILE YES/NO 


Either the "YES" or "NO" will be shown In Inverse letters for 
each Item. The Inverse lettering Indicates the current status of 
that Item. By pressing the keys "1 " through "8" you are able to 
switch the status of the Items from "YES" to "NO" and back 
again. 

Each of these enhancements modifies the version of 
ProntoDOS active In vour App/e‘s memory . You cannot 
enhance or otherwise modify the DOS on a disk without also 
using the Update feature, which was explained on page 4. 

Some of the enhancements simply change existing DOS 
Instructions a bit. Others add new Instructions to DOS as well. 

Those enhancements that require new Instructions of 
their own place these Instructions In some empty spaces 
Inside DOS. These enhancements are not the first routines, nor 
will they be the last, to try to capture this territory. 


THIS NEW DOS 
COMMAND LETS 
YOU DISPLAY THE 
CONTENTS OF TEXT 
FILES. 


TEST AIL PROGRAMS that might use the empty spaces In 
DOS— RUN the program first, then RUN PRONTO UPDATE. If the 
program has modified an area of DOS, you will be unable to 
turn on the affected enhancement. 

KEEP BACKUP COPIES of your disks. Programs that modify 
DOS empty space, when iuri AFTER the enhancements or& 
made, will cause your program to "hang up” or “crash" 


when you access the enhancement and COULD DAMAGE 
YOUR DATA. Please use care. In some sensitive situations, your 
best choice may be not to use these enhancements. 

(1 ) “TYPE" COMMAND ACTIVE 

The “TYPE" command lets you display the contents of Text 
Flies on your screen or printer. With this feature acttve and a 
disk with a text file on It In your drive. simply enter. 

JTYPE filename 

The file must be a Text File. The contents of the file will 
begin to scroll by on your screen. On most Apples you con 
stop the scroll by pressing control-S. Restart the scrolling by 
pressing control-S again, or ESC or most any key. 

You can stop the display entirely and bring the TYPE 
command to an early end by pressing ESC while the file Is 
scrol ling. If the file has been stopped by control-S you have to 
push ESC twice— once to restart the scroll (this keypress gets 
eaten by a Poc-Man). and once to stop. 

If you donl kill the display. It will expire naturally when 
the end of the file Is reached. If the file Is a Random Access 
file, TYPE expires when It hits the first empty record. (Often this 
will be the very first record of the file, Record-0, thus limiting the 
display to nothing at all.) 

Example: Once the TYPE command is active, you can 
Insert your ProntoDOS disk and see what’s In the file "DO RD" 
(the purpose of which Is explained later). If you do, here’s 
what you will see; 

JTYPE DO FID 
POKE 2051,96 
BLOAD RD 
POKE 2132,169 
POKE 2133,120 
CALL 2051 

You can also use the ”R" parameter with TYPE, |ust as you 
con with EXEC. If you use “R”. the display will skip R lines 
before starting the display. For example: 

JTYPE DO FID, R2 
POKE 2132,169 
POKE 2133,120 

CALL 2051 . 

To get a file to appear on your printer, simply use the 
normal PRistot command to activate your printer before 
entering the TYPE command. 

The TYPE command uses the position of the VERIFY com- 
mand In the DOS command name table. This means that If 
you turn TYPE on, you will be unable to use VERIFY. If you try, 
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ADDITIONAL 10 TO 
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you will get a SYNTAX ERROR. 

The TYPE command uses the DOS empty space at SBCDF. 

(2) CTRL-C KIllS CATALOGS 

This command Is useful for long catalogs. The CATALOG 
command normally stops when your screen Is full of file 
names and waits for a keypress before showing you another 
screenfull. If this enhancement Is active, pressing ctrt-C will 
bring the Catalog too natural end Instead of continuing. This 
keeps the file name you were looking for from scrolling off the 
screen before you get a chance to type It In. 

This enhancement uses the DOS empty space at $BAB7- 
$BA91. 

(3) (ESC) KILLS EXECS & READS 

If you've ever had an error In an EXEC file that caused It to run 
amuck, or If you've ever started to READ a Text File 10 miles 
long and then realized It was the wrong one. you’ll appre- 
ciate this feature. In either case, pressing ESC will bring the 
EXEC or READ to an end by telling It the end of the file has 
been reached. With READ, this will cause an END OF DATA 
error, with EXEC, It causes a natural death. 

This feature Is useful primarily to programmers creating 
and testing programs. It Is a dangerous feature to use with 
finished software, since a misplaced keystroke could cause 
Incredible problems. 

This feature uses the DOS empty space at $BCDF. 

(4) AUTOMATIC VERIFY AFTER SAVE 

Normally, both Apple DOS and ProntoDOS do an automatic 
VERIFY right after saving Binary and Basic flies. By turning this 
feature OFF, you can Increase the speed at which flies are 
saved by 10% to 15%. You do this, however, at some risk of 
data loss. 

The setting of this feature Is completely Independent of 
the setting of the TYPE command, even though TYPE deletes 
the VERIFY command. The automatic verification can still 
take place even If you can't manually VERIFY a tile. 

This feature does not use any additional space Inside 
DOS. 
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FREE-SPACE IS 
DISPLAYED EVERY 
TIME YOU 
CATALOG. 


THE ADDRESS * 
LENGTH OF BINARY 
RLES ARE 
DISPLAYED EVERY 
TIME YOU BLOAD 
OR BRUN. 


(5i FORCE LANGUAGE CARD RELOAD 

Normally, both Apple DOS and ProntoDOS will modify rone 
byte ($E000) of a Language Card during a boot. This force 
the card to be reloaded each time DOS Is booted. If you um 
this feature off (NO), the Language Card will only be loo^ 
If It needs to be. In a few circumstances, a DOS wtth this 
feature off will fall to load the Language Card when It should. 
The decision (and risk) Is yours. 

This feature does not use any additional space. 


(6) PRINT DISK FREE SPACE 

This enhancement shows you how many sectors are free on 
each disk you Catalog. For example: 


] CATALOG 

PRONTO-DOS V254 FS=123 

*A 010 FILE #1 
*B 020 BINARY FILE 
*T 030 TEXT FILE 


."FS“ STANDS FOR 
"FREE SPACE". 


This enhancement requires a rather long addition of 
assembly language Instructions and also requires the avail- 
ability of Basic. If you are using a program that Installs Itself on 
the Language Card and tricks DOS Into thinking It Is Applesoft 
or Integer Basic, this enhancement will cause a CATALOG to 

hang up your computer or worse. . 

The new Instructions are normally placed at SB6B3. if mis 
area Is already In use and the INIT command has been 
modified (Item-6 below), they will be placed at SB74A. A 
other programs also use these spaces. In particular, the 
Language Card version of GPLE uses $B6B3. See page 1 5 for 
more Information on GPLE. 


(7) PRINT BINARY FILE ADR & IEN 

This enhancement causes the Address and length o a 
Binary File to be displayed In hexadecimal when It Is 
BLOADed or BRUN. For example: 

) BIO AD DOS-UP 
AS4000 LS05BF 
)BRUN HELLO PRONTO-OOt 
AS4000 LS0458 

This feature uses the same DOS empty space as the Disk 
Free Space enhancement. Because of this, you cannot tum 
them both on at the same time unless you modify the INK 
command (next Item) and use Its space. Again, note that the 
Language Card version of GPLE also uses the space at SB6B3. 


DON7 PUT DOS 
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(8) INIT SAVES DOS & HELLO FILE 

Normally, of course. INIT not only "formafs" and erases a disk, 
but It also puts DOS on It and saves a Hello File. Nowyou can 
tum this off (NO). INIT will still work, but nothing will be put on 
the disk. It will contain 528 empty sectors. The disk will not 
boot, but It makes an excellent “Data Disk”. 

When you use this enhancement, some Internal DOS 
space at $B74A Is opened up. This space will be used if you 
tum both the Disk Free Space and Binary Fite Address and 
Length enhancements on at the same time. 

When Item-8 Is set to NO, a ninth enhancement will appear 1 
on your menu— ' 

(9) MODIFY INIT SYNTAX t 

When this Hern Is set to YES, the INIT syntax Is changed to 
)!NIT 

Notice that no file name Is used as Is normally the case, if 
a file name Is given, as In: 

)INIT HELLO 

you will receive a SYNTAX ERROR to remind you the INIT 
command has been modified. This enhancement can be 
useful, but It also causes programs that use the INIT com- 
mand, such as COPYA, to fall unless they are revised to use 
the new syntax. The choice Is yours. 

Should you modify the INIT syntax, then later reset Item-8 
so INIT will save DOS and a Hello File, the INIT syntax will be 
automatically normalized. 

“—/NO" AND “????7?" 

If an Item shows "—/NO" at the right end of a line Instead of 
the normal "YES/NO", It means the feature cannot be fumed 
on because there Is no space for It. You must tum some 
related feature off first. 

If an Item shows “???? 77* It means the DOS you are 
working with has been modified by some alien program. The 
location PRONTO UPDATE looks at to determine whether a 
feature Is acttve or not Is set to a value that Indicates the j 
feature Is neither on nor off. ' 
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HELLO PRONTO-DOS 

The program HELLO PRONTO-DOS Is to be used only when a 
situation will not allow you to boot a ProntoDOS disk. Few 
users will encounter this problem. 

The problem usually occurs when you must use a spe- 
cial DOS to Interface wtth a hard disk drtve, a disk emulator, a 
clock card, or other device. Theproblem Is that these devices 
require you to boot with their special DOS. 

In this situation, you may BRUN HELLO PRONTO-DOS after 
booting. This program checks to see If the locations used by 
ProntoDOS have already been modified, and K not, pokes 
the ProntoDOS modifications Into the special DOS. If the 
special DOS Is not located at the normal 48K DOS location, 
HELLO PRONTO-DOS will end wtth an error message. 

If the special DOS was already using any of the memory 
locations used by ProntoDOS, HELLO PRONTO-DOS will leave 
It Just as It Is and give you a message that It was unable to 
modify the special DOS. 

If HELLO PRONTO-DOS was able to modify the special 


DOS successfully, you will see a message saying ProntoDOS 
Is loaded and ready. 

HELLO PRONTO-DOS does not change anything about 
the way disks are Initialized. If your special DOS allows you to 
INlTlallze disks (most don't), you won't get the usual Pronto- 
DOS 15-extra-sector bonus. 


MOVING PRONTO- 
DOSTO HICK- 
MEMORY OR 
LANGUAGE CARO 


DOS-UP 

DOS-UP Is used to move ProntoDOS from Its normal location 
In memory to the Language Card (or "RAM Card") area 
(SDOOO-SFFFF) of memory. This requires an Apple lie OR a 
special card In an older Apple's Slot-0. The advantage of 
moving DOS to the Language Card Is that Basic programs 
will have 1 0,41 5 extra bytes of memory space to work wtth (a 
LOT of memoryl). If space Is a problem In your application, 
DOS-UP will help. If space Is not a problem, however, you will 
usually be belter-off leaving DOS In Its standard location. 

To use DOS-UP, boot ProntoDOS and then: 

)BRUN DOS-UP 

If DOS ha* already been moved, or If there Is no Lan- 
guage Card present, you will receive an error messogo. 
Otherwise, the n>e*sage"DOS NOWIN HIGH MEMORY" will be 
dL'OiayeC. 'i 



■TiOtUO - . 

;■ i te r;j 

rttyic 

.:wc-' 


REASONS NOT TO 
MOVE DOS 


HOW TO AND DOS 

>! eini , 

. , i -ic, vzoc r.-’* 
foqncouoY.v* 


Immediately after the message, DOS-UP attempts to RUN 
a program named "Hello". This Is done to create "Turnkey" 
systems that automatically move DOS to high memory and 
then execute the main program. When you BRUN DOS-UP 
from Inside a program, that program dies an unnatural 
death after DOS Is moved. The automatic running or re- 
running ot "Hello" can bring It back to life. 

There are disadvantage* of moving DOS to the Lan- 
guage Card- One Is that you can't use the card for an 
alternate language. If you move DOS. the only Basic availa- 
ble to you will be the one that Is native to your computer 
(usually Applesoft Basic). 

Another disadvantage Is that many assembly language 
programs won't work correctly with DOS on a Language 
Card. There are several reasons for this. Some assembly 
language programs Insert themselves between DOS and Its 
buffers. Few do this correctly with DOS on the Language Card. 

Another problem Is that many assembly language 
programs poke an address Into DOS to tell It what to do after 
a disk error. But If DOS Isn’t where It's expected to be. the poke 
has no effect. In this case, an error usually snatches you from 
your program and drops you somewhere In Basic. 

When DOS Is In hlgh-memory, the maximum MAXRLES 
value Is 5. rather than the usual 16. 

Yet anotherdlsadvantage Is that the INIT command must 
be modified when DOS Is moved. If you haven’t done this 
yourself with PRONTO UPDATE. It will happen automatically 
when DOS Is moved. See page 10 for more. 

Several other programs have been written to move DOS 
to the Language Card. DOS MOVER by Cornells Bongers, 
published In the July/August 1981 Co//— AP.P.LE served as 
on Inspiration for DOS-UP. However, DOS-UP has been com- 
pletely rewritten, because DOS MOVER and all other pro- 
grams like It that we have tested, have foiled to move 
PronloDOS correctly. 

To move ProntoDOS, you MUST use DOS-UP except when 
you want to use the version of GPLE called "PLE.DM". For more 
Information, see page 15. 

Your programs can tell If DOS-UP has already run or not 
by PEEKIng at location 978 ($3D2). A value Of 157 ($9D) 
Indicates that DOS Is at Its normal 48K location. When DOS 
has been moved to the Language Card, this value becomes 
191 ($BF). 

All ProntoDOS enhancements will work correctly from 
the Language Card, but you must Install them before run- 
ning DOS-UP. PRONTO UPDATE will refuse to run If DOS Is not at 
Its standard 48K location. 
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If you would like to change the Hello-program name O' 

Run Command of the program DOS-UP runs automatically 
BLOAD DOS-UP and poke the new name In at 1 7262-1 7291 
TS436E-8B). The Run Command lives at 1 7205 (S4335). Poke In 
a 6 for RUN; 20 ($14) for EXEC; 52 ($34) for BRUN. Then: 

)BSAVE DOS-UP,A$4000,U5BF 

tpthnical Detail*. Details... The rest of this section present! 

INFORMATION FOR IO me technical details about DOS-UP. These are primarily o 
fAK^ukrFRS Interest to a handful of assembly language programmers. 

Aflor DOS Is moved to the Languags Card, HIMEM Is so 
at $BEAF. The area from there to $BFFF Is used for Instructions fo 
switching the Language Card on/ off. and other purposes. 

One of those purposes Is for storage olthe HIMEM vali* 
Itself, which Is at $BFFE-FF, In the normal backwards format, 
you would like to protect an assembly language progran 
from DOS and Basic, Insert It Just below HIMEM and revise thr 
value at $BFFE to reflect where your program starts. Ther 
Coldstart DOS by calling the normal Page-3 vector at $3D3 
or use the DOS MAXFILES command. Either of thes< 
automatically resets HIMEM to whatever Is stored at $BFFE. 

While your program Is running, you may freely call Bask 
and Monitor routines. You may also freely use the Page-: 
DOS vectors. However, you cannot access other routiner 
Inside DOS unless you turn the Language Card on yourself 
There Is a subroutine that will do this for you at $BEAF. To turr 
the card off again you can call $BEDE. Don't expect the care 
to stay as you set It very long, however. Every time a charade 
passes through the Input/Output hooks, DOS Is activated tc 
fake a look at It. When DOS Is done looking and passei 
control to the appropriate Input/Output routine, the 
Language Card will be off again. 

If you look at the DO* vectors on Page-3, you will fine 
that they all point to routines on page $BF. The IOB Is at $BFD5- 
E5 and the File Manager Parameter List Is at $BFE6-FB. These 
are the same locations used by Bongers' DOS Mover. Not al 
programs that move DOS use these locations, however. You 
should always use the Page-3 vectors at $3DC and $3E3 tc 
locate the Pamnllst and IOB. 

The Internal DOS vectors normally at $9D56^1 have also 
been moved. They are now at $BFC5-D0. Of particular Interest 
are the vectors at $BFC9 and $BFCD, which tell DOS where to 
go after an error and a warmstart, respectively. You can poke 
new addresses Into these locations to return control to your 
program. Normally the addresses here send control to Basic. 
If you change these locations, beware— A DOS coldstart or a 
successful FP (or INT) command will reset the vector table to 
the addresses for Basic, and your pokes_wtll bo lost. 
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DO FID and DO RENUMBER 


THE PROGRAMS 
RD AND 

RENUMBER ARE ON 
THE SYSTEM 
MASTER DtSK THAT 
CAME WITH YOUR 
apple. 


S'* ^ ” , Z aM ApBl ° Sw ' om “<W»rdl A RD anS 

^NUMBER '■ v RENUMBER, have strange bugs In them that normally Drevent 

SmSooojBw DOS u on me longuog. Cam. 

H>GH-M emory h ° wever - v You execute them using the 

^mbpd° t ° Pron D , ° DOS dlsk called “DO FID- and "DO 
RENUMBER . To use RD or RENUMBER while ProntoDOS Is 

JEXIC DO FID or... 

)£XEC DO RENUMBER 

Bdano®* AMS Dut and °° ^NUMBER can be used, you must 

RENUMBER ARE ON ° n m ° Wme with RD and/or RENUMBER h,*a 

the system RD Itself to transfer programs while do? i« »■ « ' 

MASTER DISK that location^ 9 wni,e DOS ls at 1,1 normal 48K 

CAME WITH YOUR 

00 nD and DO RENUMBER load the SDecIfled nrr^rr,™ 
poke modifications Into |, and run 1 WhNe^SXS 

° U$e RD When °° S 18 on ,he Language Crndrt 
also works correctly when DOS Is elsewhere. 

DO RENUMBER, on the other hand, will only EXECute 
properly when DOS Is on the Language Card. Otherwise It will 
give you a message saying “HIMEM IS ABNORMAL" if this 
appens wtien DOS Is In fact on the Language Card you will 
°*» Dy rebooting DOS 

renumber your program. The only time you will usually see 
this messoge Is If you EXEC DO RENUMBER twice In one sitting 
You can thank Bongers for the Information on how to fix 

PraSToms- 1 certainly do. His fixes were Included In the 
original article mentioned above. 


PRONTO-DOS AND 
OTHER PROGRAMS 

you to boot their particular brand of DOS. See HELLO 
PRONTO-DOS on page 11 for possible help. 

ALPHA PLOT 

Beagfe Bros* Alpha Plot may be used with ProntoDOS but to 
make It work. UNE 9 of the program ALPHA BOOT should read: 

9 IF PEEK (115) +PEEK (116) *256038400 
THEN PRINT CHR$ (4) ; "PR#"; peek (43626) 


4ANY PROGRAMS 
-ENERT from vnv 

S 0 - 00 "' 



BYTE ZAP 

on the Beagle Bros Apple Mechanic disk refers to several 
areas of DOS for possible alterations. ProntoDOS relocates 
some of these areas— 

!?*™ Normal DO* ProntoDOS 

ERROR* MBsIsS Jrack-1 . Sector-7 Track-1, Sector-5 

GREETING r aC ^‘ S0Ctor ' 8 Track ’ 1 • Sectors 

GREETING NAME Track-1, Sector-9 Track-1 Sect™. 7 

RLEmcODE^^® ‘ r TraCk ' 2 * SeCf ° f ’ 2 Tfack - 2 ’ Socto '-° 

RLE-TYPE CODES Track-2. Sector-2 Track-2. Seclor-0 

UTILITY CITY 

Do not use the program KILL-CAT on the Utility City disk wtth 
ProntoDOS. The PRONTO ENHANCEMENTS program provides 

Instead* 6 f6atUre L t,erTv2 on ,he Enhancements Menu). Use It 

G.P.LE.® 

The Globa! Program Line Editor (by Nell Konzen. published 
bySynerglstlcSollvvare) Is a program we couldn't program 
without, and therefore highly recommend, tf you don't have It 
Duy ft. But... ' 

CAUTION: NEVER INITIALIZE A DISK WITH PLEAS LOADED This 
oppHes to standard Apple DOS as well as ProntoDOS H 
anything Is between DOS and Its buffers when you do an INIT 
the new disk will leave space there whenever It Is booted. This 
will cause many mysterious problems. 

GPLE comes In three versions, all on the GPLE disk— 

,he “standard" version of GPLE. Is completely 

PronfoDOS and »* enhancement,. To use 
PLEAS with PronfoDOS: 

1 . Boot a ProntoDOS disk. 

2. BRUN PLEAS. 

n„? L£ .* LC P ^* GPLE on a Language Card and uses the 
empty space In DOS at $B6B3. This means you cannot 
UPDATE'S “Print Disk Free S^be'"or 

tl^ as?LE lc o^2!? S V Len9th ‘' optlons 01 fhe 

kte.iS.rio ■ UM ond ' oadl " 9 01 nuc 11 

PLE.DM Is usod when both DOS and GPLE are placed 
on the Language Card. PLE.DM comes wtth an as, Stated 

PLEDM m v2?m e GPLE d ' Sk Ca " ed PLE 005 M0VER - To use 

DOS M^(T' U UnZ!2 ,, l^ 0 , S r ° ^ Lon Quag£LCard wtth PLE 
DOS MOVER. Unfortunately, this progra -f mcM) 

4 * 



! to »c 2 A3? 

v t’r.tyn-T, 
id iOVOi. 


SKIP THIS SECTION 
IF YOU DON! 
PROGRAM WITH 
TEXT FILES' "R" AND 
“B” PARAMETERS. 



ProntoDOS correctly unless It Is modified. 

To use PIE.DM, you must put "PIE DOS MOVER” from the 
GPLE disk and "DO PIE DOS MOVER” from the ProntoDOS disk 
on the same disk. Then: 

1 . Boot a ProntoDOS disk. ^ nl 

2. insert the disk with PIE DOS MOVER and DO PIE DOS 

MOVER. 

3. EXEC DO PIE DOS MOVER. 

The EXEC file will load PIE DOS MOVER, modlty It as 
necessary, and run It. PIE DOS MOVER will move ProntoDOS 
to the Language Cord and then try to run a Basic file named 
"Hello". 

Neither "Print Disk Free Space" nor "Print Binary File 
Address and Length" from the PRONTO UPDATE program work 
correctly Wtth PLE DOS MOVER. The other enhancements work 
fine. 


PRONTO-DOS AND 
TEXT FILES 

ProntoDOS does not speed up access of Text Files because 

text flies are handled one byte at a time. The bytes are 
passed back and forth between DOS and the current Input or 
output routine. This process Is relatively slow and unaffected 

by the ProntoDOS speed-up technique. 

Both pre- and post-Apple lie DOS 3.3's have bugs In me 
handling of the APPEND command. The two bugs are differ- 
ent. Both have been removed In ProntoDOS. 

Both versions of DOS also have a bug relating to me use 
of t fie "R" and "B" parameters with Text Files. This bug Is 
complex, and If you never use the "R" or "B" parameters.you 
may want to skip me rest of this section. 

The “R" parameter Is allowed with READ. WRITE. POSITION, 
and EXEC. The "B" parameter Is allowed only with READ and 
WRITE 

When used wtth POSITION and EXEC, me "R" parameter 
causes DOS to move forward through a file counting "car- 
riage returns". It stops at me first character following the Rth 
carriage return. There are no bugs here. 

When used wtth READ and WRITE. "R" has a complete^ 
different meaning. In mis context. It Is to beusedontywim 
Random Access Text Files, and It orders DOS to go to the Rth 
record In the file (where me first record Is 0. me second 1 . etc.). 
There ore no bugs here. 
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SKIP THIS SECTION 
IF YOU NEVER MET 
THE RLE MANAGER. 


NOTE: APPLE QUIT 
MAKING INTEGER 
BASIC APPLES IN 
196a 


The “B" parameter Is also used with READ and WRITE. 

Whenever you give a READ or WRITE command wffh either 
an "R" or "B" ( or both). DOS Immediately moves Its file pointer 
to the byte that equals: 

(R * L) + B 

where L equals the length parameterglvenwhen the die was 
opened. If no L was given (as with Sequential Files), L will 
default to 1. 

If you give an R parameter alone, or If you give both the R 
and B parameters. DOS will always make the calculation 
correctly. In the first case, where you give the R parameter 
alone, the B parameter will default to zero. 

Here’s me bug: If you give the B parameter alone, the 
default of the R parameter Is uncertain under standard Apple 
DOS. Under ProntoDOS, It Is certain— If R Is not specified, It will 
always default to zero. This fixes a bug In Apple DOS whereby 
the B parameter, used alone with Sequential Files, performed 
erratically. 

When using Random Access files, you should never use 
the Byte parameter without also giving the Record parame- 
ter. If you do not specify R when using B. the file pointer will be 
moved to me Bth byte of record-zero. Under standard DOS, 
the pointer usually, but not always, moves to the Bth byte of 
the last record specified. 

Programs that call the File Manager (a program within 
DOS) directly, must use ONE-BYTE Reads and Writes when 
working with Text Flies. Just as DOS Itself does. Under Pronto- 
DOS. the File Manager's Read- and Write-Range routines will 
not return an End of File error, nor do they keep track of 
Random Access file position. This Is a concern only wtth 
programs that call the File Manager directly and use the 
Read- and Write-Range routines on Text Files. Programmers 
who only use DOS commands such as OPEN. POSITION. READ 
and WRITE should Ignore this paragraph. 


PRONTO-DOS AND 
INTEGER BASIC APPLES 


This section pertains to owners of Standard Apple II 

computers who use me version of Applesoft known as 
"cassette" or "RAM" Applesoft. 

It doesn't apply to those who have an Apple II-Plus or 
who never use Applesoft or to users of "ROM" Applesoft cards 
or users of "Language Cards". V you have an Apple IFPlus or 


never use Applesoft or If you use one of the "cord ' versions, 
' ' ,N !0 1 ’ ( 1 you may Ignore the rest of this section. 

; (cr) still reading, huh? There are not many like you left In 

Appledoml , ^ 

prontq-dos Well, I must offer my apologies. ProntoDOS doesnt 

doesnt SUPPORT support cassette Applesoft. If you like, you may return 
CASSEnE ProntoDOS, or you could try to pick up a used Applesoft ROM 

APPLESOFT. card ( these jhould be available In many cities for next-to- 

nothlng), or get a 1 6K RAM card. 

Even though ProntoDOS doesn’t support cassette 
Applesoft, It still will automatically run an Integer file called 
•‘Applesoft’’ when you tell It to run a program written In 
Applesoft. If this file Is, In fact, cassette Applesoft, you will 
shortly find yourself In a big mess. Don’t do It. 

i the Integer program, ‘‘Applesoft’’, Instead loads 
FPBASIC Into a language card, however, all will be right with 
the worldl 


USE BINARY FILES 
INSTEAD OF TEXT 
FILES TO TAKE 
ADVANTAGE OF 
PRONTO-OOS’S 
INCREDIBLE SPEED. 




SAVING ARRAYS IN 

FAST BINARY FILES 

he nomnal method for saving numerical arrays Is In Text Files, 
[his can be quite timeconsuming with large arrays, however, 
because of the slow speed at which DOS handles Text Files. 

There are certain locations you can PEEK to find out 
#here an Applesoft array starts, and a simple formula that will 
alve you the array's length. Using this Information, you can 
BSAVE the numbers In the array In Just a few seconds. In 
addition to saving time, you will also find you save disk 
space. An aiTay saved In a Binary File Is usually shorter than 

the same array In a Text File. 

This file can be BLOADed back Into the same program or 
Into any other program that Includes an array DlMensloned 
to the same size as the original array. 

How to determine the ADDRESS of arrays: Applesoft 
keeps the address of the lost variable used at memory loco- 
tions 131-132 ($83-84). Retrieving this value Is a blj tricky, 
however, since any variable used In the statement retrieving 
thevakle* becomes the “lad variable used”. Here are two 
ways to do It. In this example “A( )” Is the name of the target 

afTa iMETHOD 1: A(0)«PEEK(131)+PEEK(132)*256 

In this method, the address of the array Is stored In the 
zero-lh element of the array Itself. 


1<5 
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METHOD 2: 

A(0)=A(0) : POKE 78/PEEK(131) : POKE 79 , 

PEEK (132) : AA=PEEK (78) +PEEK (79) *256 

In this method, the address of the array Is stored In the 
variable AA. Don’t separate the parts of this method, as the 
Intermediate memory locations It uses are scrambled by 
various routines. 

Note that the reference to the array must be to Its zero-th 
element In order to get the starting location correctly. For a 
multi-dimension array, the reference should be, for example, 
“A(0, 0. 0. 0)”. 

How So determine the LENGTH of arrays: This Is simple. 
The length Is five-times the number of elements In the array for 
Floating Point arrays, and two-times the number of elements 
for Integer arrays. The only trick Is that the number of 
elements” Is always one more than the number you 
DlMensloned the array with, because of the zero-lh element. 
Some examples, where ”$’’ represents the size of the array 
and ’’AL” represents the array's length: 

Rooting Point Arrays: DIM A(S): AL=(S+1)*5 

Integer Arrays: DIM A%(S)t AL=(S+1)*2 

Multl-DImensloned Arrays: DIM A(Sl f S2,S3,S4) : 

AL= (Sl+1)* (S2+1) * (S3+1) * (S4+1) *5 

All Together Now... Once you have DlMensloned an 
array and used these formulas for determining Its Address 
and Length, the following commands will load or save It 
where AA equals the Array Address: AL equals the Array 
Length; F$ equals the Name of the die; and D$ Is our old friend, 
contTOl-D. 

To Load: PRINT D$; "BLOAD ";F$;",A";AA 
ToSave: PRINT D$;"BSAVE ";F$;",A";AA;\L";AL 

Most people already know this, but I was surprised after 
using Apple DOS for many months to find out the A and L 
parameters In the above commands can Indeed be 
decimal (OR hex) numbers. 

This information on piTayi comes frsm g letter m me June 
1980 Co/f-AP.AU by Wayne Throop and a lample pro- 
gram by Richard C. Horsfall In the January 1981 Issue of the 
same magazine. Horsfall also Includes Information on serv- 
ing Integer Basic arrays. 
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Alpha Plot 


afI °y* 

® Parameter 


binary fl| 0 , 

Byte Zap ” * ” 

cassette Applesoft . . . , 


customizing 


DOS4IP 


enhancement* . . . . 

ESC 


no 


IS 

™eger Bade Apple, 2 ' 1| $ ” 
KILL-CAT "..J. 17-18 

• ...18-19 

language cart. . . 



licenses.. 

3 * 9 * <M4 
inside front cover 

9. 18-19 

maxrles. 

Inside front cover 

...17-18 

memory usage. . . 
-•/NO.. 

PLE® . . 

...3, 6-10, 11-14 


pnnr disk space 
print binary adr 

pronto update 

717777 . 


7-8. 14 

P parameter . 

£° n f*°m Access nies 
READ, killing 


.11-14 
..6-10 
. 7,8 

Run Command 

skew.... 

syntax for INIT 

•Vntax for TYPE 




free space 2 

GPLE® 3 * 9 

herd disks ,-15-1 6 

HELLO fl/e 3, 11 

himem. 4 *1 

" 

7i •, 


^command 7 ’ 16 " 17 

updating dltkt 

Utility Ctfy 

VfRHY 

Winchester disk*' *° nf c 3 °^ f 


I Q. Can I load opTtb n . 

'” n ‘° D0 ° “ 

BBTOOPLB.48 ' booting ProntoDOS: 

BKDK DOOTLE.TAKE.48 

l^or the Lan/tuArfA po j 

®!S36S?SSSSi* *S*M to -*»* I 
20 rows a vs** ,k 

» you Want DOS mov./ DOU BU5.TAja ! . L c. 

c; ’ bruwd °uble-take.dm« 



PRINTED IN SAN DIEGO 


